<!DOCTYPE html>
<html lang="zh-CN">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>登录接口文档</title>
    <style>
        body {
            font-family: Arial, sans-serif;
            line-height: 1.6;
            margin: 0;
            padding: 20px;
            color: #333;
        }
        .container {
            max-width: 1000px;
            margin: 0 auto;
        }
        h1 {
            color: #2c3e50;
            border-bottom: 2px solid #eee;
            padding-bottom: 10px;
        }
        h2 {
            color: #3498db;
            margin-top: 30px;
        }
        h3 {
            color: #2980b9;
        }
        .endpoint {
            background-color: #f8f9fa;
            padding: 15px;
            border-radius: 5px;
            margin-bottom: 20px;
            border-left: 4px solid #3498db;
        }
        .method {
            font-weight: bold;
            color: #fff;
            background-color: #27ae60;
            padding: 5px 10px;
            border-radius: 3px;
            margin-right: 10px;
        }
        .method.post {
            background-color: #2980b9;
        }
        .method.put {
            background-color: #f39c12;
        }
        .method.delete {
            background-color: #e74c3c;
        }
        pre {
            background-color: #f1f1f1;
            padding: 10px;
            border-radius: 5px;
            overflow-x: auto;
        }
        code {
            font-family: Consolas, Monaco, 'Andale Mono', monospace;
        }
        table {
            width: 100%;
            border-collapse: collapse;
            margin-bottom: 20px;
        }
        th, td {
            border: 1px solid #ddd;
            padding: 8px 12px;
            text-align: left;
        }
        th {
            background-color: #f2f2f2;
        }
        tr:nth-child(even) {
            background-color: #f9f9f9;
        }
    </style>
</head>
<body>
    <div class="container">
        <h1>登录接口文档</h1>
        
        <p>本文档详细说明了用户登录和注册接口的使用方法、请求参数和响应格式。</p>
        
        <h2>基本信息</h2>
        <ul>
            <li><strong>基础URL</strong>: <code>http://localhost:8080</code></li>
            <li><strong>内容类型</strong>: <code>application/json</code></li>
            <li><strong>字符编码</strong>: <code>UTF-8</code></li>
        </ul>
        
        <h2>接口列表</h2>
        
        <div class="endpoint">
            <h3><span class="method post">POST</span> /api/users/login</h3>
            <p>用户登录接口，验证用户名和密码是否匹配。</p>
            
            <h4>请求参数</h4>
            <table>
                <tr>
                    <th>参数名</th>
                    <th>类型</th>
                    <th>是否必须</th>
                    <th>描述</th>
                </tr>
                <tr>
                    <td>username</td>
                    <td>String</td>
                    <td>是</td>
                    <td>用户名</td>
                </tr>
                <tr>
                    <td>password</td>
                    <td>String</td>
                    <td>是</td>
                    <td>密码</td>
                </tr>
            </table>
            
            <h4>请求示例</h4>
            <pre><code>{
  "username": "admin",
  "password": "admin123"
}</code></pre>
            
            <h4>响应参数</h4>
            <table>
                <tr>
                    <th>参数名</th>
                    <th>类型</th>
                    <th>描述</th>
                </tr>
                <tr>
                    <td>success</td>
                    <td>Boolean</td>
                    <td>登录是否成功</td>
                </tr>
                <tr>
                    <td>message</td>
                    <td>String</td>
                    <td>登录结果消息</td>
                </tr>
                <tr>
                    <td>username</td>
                    <td>String</td>
                    <td>登录成功时返回用户名，失败时为null</td>
                </tr>
            </table>
            
            <h4>响应示例 - 成功</h4>
            <pre><code>{
  "success": true,
  "message": "登录成功",
  "username": "admin"
}</code></pre>
            
            <h4>响应示例 - 失败</h4>
            <pre><code>{
  "success": false,
  "message": "用户名或密码错误",
  "username": null
}</code></pre>
            
            <h4>响应状态码</h4>
            <table>
                <tr>
                    <th>状态码</th>
                    <th>描述</th>
                </tr>
                <tr>
                    <td>200 OK</td>
                    <td>请求成功处理</td>
                </tr>
                <tr>
                    <td>400 Bad Request</td>
                    <td>请求参数错误（如用户名或密码为空）</td>
                </tr>
                <tr>
                    <td>500 Internal Server Error</td>
                    <td>服务器内部错误</td>
                </tr>
            </table>
        </div>
        
        <div class="endpoint">
            <h3><span class="method post">POST</span> /api/users/register</h3>
            <p>用户注册接口，创建新用户。</p>
            
            <h4>请求参数</h4>
            <table>
                <tr>
                    <th>参数名</th>
                    <th>类型</th>
                    <th>是否必须</th>
                    <th>描述</th>
                </tr>
                <tr>
                    <td>username</td>
                    <td>String</td>
                    <td>是</td>
                    <td>用户名</td>
                </tr>
                <tr>
                    <td>password</td>
                    <td>String</td>
                    <td>是</td>
                    <td>密码</td>
                </tr>
            </table>
            
            <h4>请求示例</h4>
            <pre><code>{
  "username": "newuser",
  "password": "password123"
}</code></pre>
            
            <h4>响应示例 - 成功</h4>
            <pre><code>"用户注册成功"</code></pre>
            
            <h4>响应示例 - 失败</h4>
            <pre><code>"用户名已存在"</code></pre>
            
            <h4>响应状态码</h4>
            <table>
                <tr>
                    <th>状态码</th>
                    <th>描述</th>
                </tr>
                <tr>
                    <td>200 OK</td>
                    <td>注册成功</td>
                </tr>
                <tr>
                    <td>400 Bad Request</td>
                    <td>请求参数错误或用户名已存在</td>
                </tr>
                <tr>
                    <td>500 Internal Server Error</td>
                    <td>服务器内部错误</td>
                </tr>
            </table>
        </div>
        
        <h2>测试账号</h2>
        <p>系统在启动时会自动创建以下测试账号：</p>
        <table>
            <tr>
                <th>用户名</th>
                <th>密码</th>
            </tr>
            <tr>
                <td>admin</td>
                <td>admin123</td>
            </tr>
            <tr>
                <td>test</td>
                <td>test123</td>
            </tr>
        </table>
        
        <h2>数据库配置</h2>
        <p>本应用使用MySQL数据库，配置如下：</p>
        <ul>
            <li><strong>数据库URL</strong>: <code>jdbc:mysql://localhost:3306/test_db</code></li>
            <li><strong>用户名</strong>: <code>root</code></li>
            <li><strong>密码</strong>: <code>123456</code></li>
        </ul>
        <p>请确保在运行应用前已创建名为<code>test_db</code>的数据库。</p>
        
        <h2>本地运行说明</h2>
        <ol>
            <li>确保已安装JDK 17或更高版本</li>
            <li>确保已安装MySQL数据库并启动服务</li>
            <li>创建名为<code>test_db</code>的数据库：
                <pre><code>CREATE DATABASE test_db;</code></pre>
            </li>
            <li>使用Maven构建并运行应用：
                <pre><code>./mvnw spring-boot:run</code></pre>
                或在Windows上：
                <pre><code>mvnw.cmd spring-boot:run</code></pre>
            </li>
            <li>应用将在<code>http://localhost:8080</code>上运行</li>
            <li>访问<code>http://localhost:8080/api-docs.html</code>查看此API文档</li>
        </ol>
    </div>
</body>
</html>